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GENERAL DESCRIPTION 


SYSTEM/BACKUP is an MCP utility which enables the user to print 
or punch backup files. Iapleaentation of the backup file secha~ 
nisa in the operating systea is not discussed here. Printer and 
punch files say be directed to backup tape or disk for tater 
processinge | : 


SYSTEM/BACKUP runs on B1700 and B1800 systems under control of 
the MCPII. The programs may be executed via the PB controt string 
or autosgatically» using the Auto Sackup CA8) capability avaitabie 
with MCPII 6-1 or tater. SYSTEM/BACKUP will vie for systen 
resources as any other normal state program except in Auto Backup 
mode when SYSTEM/BACKUP has special privileges in obtaining 
output devices. The program runs at default priority % with a 
working set of approximately 4-5KB-. | 


RELATED DOCUMENTATION 


Name | Number 


B1800/B1700 mCP ITI P.Se 2212 5462 
B18900/B1700 Software Oper at ional Guide 10687 31 
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INITIATION AND OPERATION 
PB CPrint/Punch Backup) 


The PB message is entered on the consoles (from cards» or through 
a ZIP coamand. The MCP rejects any invalid syntax and displays 


appropriate error sessageSse The MCP generates the necessary. 


execute control string and SYSTEM/BACKUP is executed. 


If PB=/= was specified» two copies af SYSTEM/BACKUP are executed 
providing both punch and printer fites existe With a multiple 
file specification (€=/=» PRT/=» PCH/=)» a file CNUMBERS) is 
passed to SYSTEM/BACKUP containing the names of the backup files. 
In the case of a single file specification (P8' 123 SAVE)» the 
NUMBERS file contains option infora2ztion. The options possible 
are SAVE» SINGLE» DOUBLE» COPIES» HOSTNAME» UPPER» RECORD» KEY» 
RANGE» EQUAL and output hardware. In the single file specifica~ 
tions the backup file name is fite equated in the execute state= 
mente , 


In operations the input backup file», BACKFILEs is opened. The 
File Parameter Block CFP3) of the originat print file is 
contained in the initial portion of the backup file.» This FPB is 


read and written to the. FPB of SYSTEM/BACKUP®s output files 


OUTFILE. The output file is then opened and the backup file 
printed/punched according to the PB specifications. This process 
toops Carutltiple file specifications» COPIES» or FPBeREPETITIONS 
NEQ 0) until the files are exhausted er the specification satis= 
fied. 


If specified» the unittmnesonic must be a tape (MT) or disk CDC» 
DK» cr DP) devices and must indicate to the MCP the location of 
the requested backup fite or files. If the unit"msnemonic ts 


Omitteds the default backup designation (BD) disk wilt be 


assumede 


Ordinarily» backup files are removed after they are printed or 


punched. Where user-named backup files (CU.-N NAM <nase>) are 


concerned» howevers a special condition exists? they are not 
removed after they are printed or punched out unless the default 
condition is overridden. The default Cno removal) can be changed 


by setting program switch two CSWN2) to a non-zero value. When 


program switch two its set to a non-zero value C(SW2=1)> user~nased 
backup files are removed after printing/punching.~ These condi- 
tions also apply when AUTOBACKUP is sete 
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Formats 


j =< , 
f 
“== <us/pw> =">1. 


I-- COPIES ------------------ <integer> ------------>1 
} j-- = ==>] i 
1 | | | 
Pm" UPPER coer e enn nne nnn ne eee n nnn eee ee 2 ===> | 
i i 
I-- HOSTNAME ~---~--<hostname>---------------------->1 
i i 1 ii 
i- = >I ee oe ee 
: 11 a 
| I-(---- SAVE -----)->1 1 
1 3 | I : } 1 
1 Ls l 
i i 


{= NOLIST =>1 


i 

I 

| 

1 

i 

i 

1 

i 

i 

1 

i 

j 

i 

i 

tees SINGLE Sere e terete ee ee ee ee eee 
f § i= DGUBLE =>! | i 

ae 7 
1 ie RECORD: -"= <integer@1> “ates es2 <2 seereser SS oe==>1 
| | | i i i 

1 1 I-- <integer“2> ~>1 I 

if | | | i 

P t-- <output Unit snemonicr® seer rr ersrrrsressrrrccre=> i 

1 1 | i 

f i-~ KEY --- TeOmoy ter nae ee go | i 
j I i I 
I i- <coluan> <length> == >4 | 
! i 
i i 
} >>w—~ RANGE <stringw1> <stringw2> eer tesesereren—->1 
i iE | | i 

I bes EQUAL. <Stt ifig=3>. -<S2e tee seereeeseeee es >| 

i 
t 


i | 1 
i- LABELS -—>1 
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<file-speci fier> 


i i 1672 PRT/= Seana Se eeS eS =>] 
t-- <unit~anemonic> *>$ lec PRN/= secsescsreses ===>] 
i-- <unitename>/ eee7>) Fees PCH/= ceeeeessrsrse-==>] 

Poessecncer-- <nuaber> ---->!1 


i i-- £ =>] 1 
! Jer Z =>! | 
| | 


| im /<name> ->1 


The PB input message causes the printing and/or punching of 
existing backup files. When the =/= option is used» all backup 
files existing on the designated disk or tape at the time the 
message is entered are printed or punched. If both printer and 
punch backup files exist on the disk» two copies of SYSTEM/BACKUP 
are executed: one copy handles printer files» and the second 
copy handles punch files. The PRT/= and PCH/= options cause the 
printing or punching of att printer and punch files» respec 
tively» that exist on the designatec unit. PRN/= is an accept- 
able equivatent of the PRTI/= option. 


Options may also be used to control the output and action taken 
by SYSTEM/BACKUP. No options may be used when the =/= option is 
specified. If options are needed for both printer and punch 
files» then the use of PRI/= and PCH/= with options wilt be 
acceptede The options» in alphabetical orders are defined as? 


COPIES 


Causes SYSTEM/BACKUP to produce <integer> coptes of the specified 
backup filee One copy is the default if this option is not spec” 
ifiede 


DOUBLE 


Causes SYSTEM/BACKUP to double-space the entire printer Listing» 
overriding any carriage control specified in the backup fite. 


HOSTNAME 


Causes SY STEM/BACKUP to transfer the backup file to the specified 
<hostname>.j If SAVE is specified with this options the file will 
be saved on the receiving host after the transfer. If NOLIST is 
specifieds the backup file will not be printed or punched on the 
receiving hoste The receiving host always has final say as to 
the disposition oF the file it receivese | 
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KEY 


Use of the KEY option atlows specification of a range of records 
to be printed or punched according to information within the 
records themselves Ce.ge» a sequerce number). Att records in the 
file wiitl be printed or punched if this option is omitted. The 
portion of each record to be comparec ray be specifted» as well 
as the information that will start and stop the output. 


The <cospiter-name> option causes automatic generation of the 
proper colugn nuaber and tength pair that corresponds to the 
sequence number field of the output. listing produced by the specm 
ified couapiter. The permissible. cospiler-nanes that can be used 
ares’ BASIC» COBOL» DASDL» FORTRAN» IL» NDL» RPG» SDL and UPL. 


The <colunn> specifies the beginning column number of the 
subfield to be used for the compare arguments and <tength> spec 
ifies a length which sust be greater than 0 and less than 10. 


The RANGE and EQUAL parameters specify the argument to which the 
subfieid in each record is to be corgpared» and the action to be 
taken when a “true” comparison is detected.- The strings can 
consist of either integerCs) or alphanuaeric Literat€s) enctosed 
within quote sarkse When the comparison arguments are of 
different lengths» an integer string is either left-truncated or 
teft zero-fitled to the same length as the subfields an alphan~ 
numeric literal is either right truncated or right space~filled 
to the same tength as the subfield. 


If RANGE is specifieds printing or punching begins when an exact 
comparison is made between the subfield and <string~1>. . The 
printing and punching continues until an exact comparison 1s made 
between the subfield and <string*2>»2» or until the end-of-file is 
reacheds whichever occurs firste | 7 


If EQUAL is specified» printing or punching begins when an exact 
comparison is sade between the subfield and <string-3>» and will 
continue untit end-of-file is reached. 


If <string-1> is equal to <string=2>> the entire backup file will 
be searched. Every record in which the designated subfield 
matches <stringw1> is printed or punched- 3 


Since the specified comparisons require an exact match between 
the string and the subfields no ae cueeray: ordering of the backup 
' file is assumed. > 


This option is not valid when any. cf the “=" options are speci~ 


Notes If both the RECORD option and the KEY option are speci= 


ens 
wee Ee ag tT ae eo ee 
Soe Sa Ct E  Vrpib don = Nesp epee een Gongs Sire 
was dbs RS Sa big hte achdlle aonath 


eye Nees ee 
PCE SRC RIRW ner 
A Ro See aR 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


fied in the same statesent>» 
the KEY option witl be made 
specified by the RECORD options. 


records 


COMPANY CONFIDENTIAL 
B1800/B1700 SYSTEM/ BACKUP 


Pe Se 2222 2681 CE) 
the cogparisons specified by 
only within the range of 


This defines 


the intersection of the two specifications. 


RECORD 


Allows specification of a range 
punchedj Qutput will begin with 
<integer-1> Cthe first record in 


cf 


records to be printed or 
the physical record specified by 
the backup file is reccerd number 


i) and continue until the physical record specified by 
<integer~2>. If <integer-2> is omitted» end-of-file is assumed 
as the terminator. ALt records in the file are printed or 


punched if this option is omitted. 


This option is not valid when 


any of the “=" options are specified. 


SAVE 


Causes SYSTEM/BACKUP to tleave 
file is closed. 
option is 


omitted. Tape 


The file will be 


the backup file on disk when the 
removed from disk if this 


backup files are always closed with 


release» so specification of SAVE is unnecessary. 


SINGLE 


Causes SYSTEM/BACKUP to single-space the entire printer 


Listing» 


overriding any carriage control specified in the backup file. 


UYEPER 


Causes SYSTEM/BACKUP to 
upper case before printing. 


S<ynit=anesonic> 


If this option is inctuded» 
card punch (CD or CP)» 
following the backup fite 
SYSTEM/BACKUP to direct 
that unit is evaitable. 


ALTO BACKUP 


When Auto Backup is actives acopy of SYSTEM/BACKUP 


designated printer is executed. 
files are entered in a community 


names are read and written to OUTFILE*s FPSB. 


processing 1S the same as with a 
files are removed after 


special forms wilt not be printed by auto backup. 
printed with a PB statement. 


it must specify a 
and must be the first option specified 

name 
its output to the designated unit» 


printings 


> 


translate alt tower case characters to 


printer CLP) or 


or nusber. It wilt cause 


if 


for each. 
The names of the existing backup 
queue files AUTOPRI NT. The 
The individual fite 
sispte PB CPB 123). The backup 
Backup files that request 
They must be 
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The Auto Backup sechanism may be overridden for a particular 
backup file during execution or coapilation by specifying NO 


AUTGPRINI or NO ATPpj $$$NO ATP sets a bit in the FPB called 
FPBeAUTOPRINT which prevents the file froem being printed by Auto 
Backup. In order to get the fite printed» you sust PB it 


yourself. When the file is PBed» SYSTEM/BACKUP resets FPBeAUTO- 
PRINT so that aNOQ ATP file that is PBed and then OUed to disk 
can be picked up by Auto Backups 


File equating is the seans by which FPS.AUTOPRINT is set or 
reset. The syntax for file equating the AUTOPRINT field is: 
>=- FILE -- <filename> ----7-------------- AUTOPRINT ---------># 
= -Je- NO =->1 Jom" ATP een-nn>I 
AX COMMANDS 


AX commands affect only the file being printed at the time the AX 
ccmmand is entered. 


TEACH or HELP Disptays explanation of AX commands and switch 
settingse | 

WHERE | Disptays nuaber of records written and EOF 
count for the file. 3 | 

COPIES | Displays nusaber of copies yet to be printed. 

SINGLE Single spacing overrides any carriage control. 

DOUBLE Double spacing overrides any carriage control. 


+ or ° <integer> Spaces forward (+) or backward (-) <integer> 
records in the file. A warning is printed in 
the Listing. : 


SAVE Fite is saved after printinge 
RE or REMOVE File is purged after printing- 
QT or QUIT Terminates printing of current file. 


Remaining files wilt be printed. 


QT END or QUIT END Terminates program after current file is 
printed. | | 


UPPER | Transtates ait lower case characters to upper 
case before printing. 


LOWER | Resets UPPER to allow printing of lower case 
characterse | | 
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SHITCH SETTINGS 


Switch settings apply to ail the fites printed during a partic= 
ular execution of SYSTEM/BACKUP. 


SW1=1 
SW2=0 
SW3=0 


2W6=0 


SW7=1-14 


SW7=15 


3W8=1-°15 


Single spacing overrides carriage control. 
Alt user-backup-.name files are saved. 
Ail files are removed. 


FPB.EOP is set to 0 to cverride each file's original 


end~“of“page actione When SW6-i1» FPBe-EOP remains 
unchanged. If FPS.&EOP=0 and there is a channel 12 
punch on the printer®s carriage controt tapes the 


printer file wilt automatically eject at the end of 
each page to avoid printing over the perforations 
between pages. 


When AUTOBACKUP is set» SYSTEM/BACKUP does not go to 
EQJ as soon as alt files are printed. Instead» tt 
waits up to 5 minutes for a new backup file to be 
released before it goes to E0QJ. 


When AUTOBACKUP is set» SYSTEM/BACKUP does not go to 
EOJ as soon as att the fites are printed. Instead» it 


watts for a new backup file to be released. 


Causes banner to be printecs banner is omitted if file 


is untabeled or if *FORM" is sete 


y Mee re 8 SR ta ly MR OR i ae tag Ae, A Mi es gteghy vie a ek we rata"), SEMEN ag viele eT Te beet 4 
ak Fon aor, pet eg AE Pelee ee UA Piles fala TB wR MER aw thy wel As Mens Zt RvR ee es eg ele ee see le Gt wear EET 
ROAST eae OF ae ea ee Ue SP 7k Sue Ce ee RAT tng enh re Ee oy 2G PANT, ; re 
cht ct Se Coe Nyaa Ng ie Be Ye Pe en oe reese: i PRA SSSCe PRES e. TM aha SG Ue id: now #4, 
(POA aaa Si i Re ; ae : : 
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FILES AND INTERNAL STRUCTURES 
NUMBERS EILE 


This is an *internat* disk file knewn only to SYSTEM/SACKUP and 
the MCP. It has a 10-byte recordsize and is blocked 18 records 
per blocke The first record contains two (2) numbersbits 8-31 
and bits 32755. The first nuaber indicates how may option 
records fotllowe and the second nuasaber specifies in which option 
record the <hostnanae> begins. Each following record contains 
either a 10 character FILE-ID or 8&0 bits of encoded option spec~ 
ificationse If HOSTNAME is specifiecs then the given <hostname> 
spans two C€2) option records» with the options SAVE and NOLIST 
specified as the Last 2 bits of the second record. fhe format of 
the 80-bit option records is as follcws: 


QPITON RECORD 


00 

SAVE specified 

DOUBLE speci fied 

output hardware specified 

COPIES speci fied 

SINGLE specified 

upper case only. 

UNIT NAME of output hardware specified 
nugber of COPIES 

unused 


01 
000 


=e] 

anbs 

a 

ne 
| 

& 
“ou 


Bit 8-7 15 starting KEY cotuan 
Bit 16 - 23 KEY Length 

Bit 2-7 4 = 010 | | 
| Bit 8 - 79 RANGE start 
Bit 27 4 = O11 | | 

| Bit 8 - 79 RANGE stop 

Bit 2- & = 100 

Bit 8 - 79 EQUAL record 


RECORD RECORD 
Bit 0 - 1 


Bit 8 - 31 
Bit 32 = 55 


10 
RECORD start 
RECORD stop 


tou i 


Bp clitiiay Nslettnds Boat Sa R eS see BRA a Re ONS og, Tig AS OER » 3 eae oe os we = el 
Arai eet Bins Preemie rare ot Sone ee ine on ag [ot ty BRS eo Taek Seg Po Teh OTHE 
aN a TAR aL ALN REET i Racine cee Eda AE a8 we é atthe ew secs “abl ; 


Sis Be Ais ed afp S ash a St OPE eprint Del acto ooh dba “oe MAB AASE Soden ig BoP Yo dee ne Glas elgg CALL A SATE SPRL less ST Gh SG CABS be AV OE WL RISa Sid Boe Reel WEEE SPER EEL SW rEg it od Lea tev PIGS ERP EREE EEO LE TEES BLS PREM 16 GLE on me ABN ia eae in Ut Tie ETE GS Eee Ne ee ee ay en 
a iad Ba eS sah Ago a Barras Sieh att ng oe ia CASE BISA MES Sa Lt oe oh eg TAK BRAT ALR A Me tc ie NS i Sa ag AS Ag ood 9 Pe eee ee A ee ee ed ea Sa a eas EMER SE IEN CONE TORS eM eae Se wT ae ee) me Cen iat eels Ta re Rip er cas ot ae : , : 


vane) Sa Ey od SR Rg EF ote 
nip tes OASLA GALS Sag nde hadnt ks LL Es aac 
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BACKFILE FILE 
BACKFILE contains control information on the backup disk or tape 
file to be processed plus the actuat file itself. File equation 
is included in the MCP-generated execute statement to identify 
the following variables: 

- The nameCs) of the backup fileC€s) to be processed 

- Whether the input is from tape cr disk 


Backup files contain header records and the programa~generated 


backup file. Header records contain control information for 
SYSTEM/BACKUPs the ocriginat FPBs and the output Label for the 
file. Nonmheader records are prefixed with eight bits of. 


carriege control informatione 
Header records are described as follows: 
CONTROL INFO 


24 Bits recordsize 


6 Bits increments filler to align recordsize for PE and 7TK tape 
“Pestrictionss subtracted from recordsize to get actual 


user data 
18 Bits control info Length 
24 Bits FPB length 
24 Bits Label length 
4 Bits tabel type 
4 Bits forsat 


Fre 


Beginning on a record boundary» the criginal printer/punch file's 
FPB is stored. 


LABEL 


Following the FPB is the original file*s output tabetls» atso 
beginning on a record boundary. 


FORMULA 


The nuaber of records described as a *few" above» and necessary 
to contain the header records is dependent on the original prin- 
ter/punch file's recordsize. With the norsral printers 132 byte 
recordsize»s 4 records are required to contain the control infor- 
mations FPB and Label. 


= Se bet oe . f cae : a eS ee er 
te tm tee tt ., ' re reer ae ome 4 ethno eet = . ‘ b 2 ss as eee Te a ee, a Re eee 
nat wy Le hs Seren bt 2 re eB asap peceten ro OC sic 1? A eet ae vai Betzee oe Te Re Pers TUE 
Pra a A See eT fe Se ee ere Ne I teeta Hea Oa Bear ee cB ee, . RSE ta TS Fe ieee 
Shae Peay, ote Gee celié W035 Sipe, Actes ee iat g senate Sse Ren RST AT TT Re aac Mae AOR eo 
BF ceska fiakas aas Pens Seed Ca as eS Bana sabi S8tEL ide et is VD AT RL DEER ROSSER WED tae ea Re YS 
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Total header records Ccontrol info size + recordsize-1) 


Jrecordsize Cround up) 


+ CFPB Length + recordsize-1) 
/recordsize 


+ Clabel length + recordsize-1) 
/recordsize 


CARRIAGE CONTROL 


Following the header records are the actual user records» each 
prefixed with an 16-bit carriage control specification. The 
user*s original WRITE or POSITION cce#municates are encoded in 
these 16 bits- Four cases of the two comsgunicates are handteds, 
WRITE» WRITE WITH STACKER SELECT Cpunch file)» SPACE Np» and 
SKIPe TOQeCHANNEL-} The 16 bits are nusgbered 0 through 15» left to 
right. | 


Bits 0-2 Reserved 


Bit 3 OQ Means write before spacing 
i= Means write after spacing 


Bits 4-711 Contains spacings chanrel or stacker 
, inforrgation depending on the value of 
Bits 12-15 


Bits 12°15 Used to identify one cf five cases 


Case G000 - Write with skip to channel 

Bits 4°11 cecntain channel inforration 
Write with stacker 

Bits 4°11 contain stacker information 
Space 

Bits 4°11 contain spacing information 
Value 0-255 | 

Skip to channel 
Bits 4°11 contain channel information 
Write with spacing 

Bits 4°11 contain spacing information 
Vatue 06-255 


Case Q001 


Case 0010 


Case 0011 


Case @100 


AUTOPRINT EXILE 


The AUTOPRINT file ts a queue file with S3i-byte records» 2 
buffers and 150 maxisum messages~- AUTCPRINT ts used onty in Auto 
Backup modee Each record contains 4 30 character backup fite 
names CPACK.ID»  MULTI.FILE.ID>» FILE»ID)» and eight bits of 
control information. This queue file is shared by ail 
SYSTEM/BACKUPS inittated by Auto Backupe | 


wt ¢ . ~~ Po . fare 
wee Pe hd eee P OMRUR te meter ee ee pare er ere ae ea tne 
See eae es wR EE ge ST SIR as eh oe aperta 
Ue a pe EFS ae hp aicatied eee Sa a RE eS La ata Be ab Te aa i ry at ag ae v2 GENE ay 922 Bag Ee Hes 
aE SP SGI eA CARN EIN La Fe re is ci nance ae OSES 
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OUTEILE EILE 


This file is the eventual output printer or punch file whose FPB 
has been written from the FPB contaired in the header records of 
BACKFILE. Certain FPE fields say be changed when the original is 
written. They are: | 


0 > Z atlow implied open 


FPB.COB8OL 23> 

FPBeLABEL.~TYPE s3s= tabel type in control info 

FPB.RECORDSIZE 3s= if punch» then 224 characters; 

else 132 characterss 

FPBe-RECORDS-jBLOCK ss= 13 

FPB.BUFFERS ss= 2 : 

FPB.HDWR ss= printer cr card reader 

FPBeAUTOPRINT s3= QO >- 2 backup print can be picked up by 

~ | | auto~backup | 

FPBoUNIT.jNAME ss= 7 = >» Z if unit name was not a 
| printer cr punch unit 

FPB.USERe-BACKUP.NAME ss= 0-7 Z will generate a regular 


backup name 
0 > 


FPBe TRANSLATE 
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ERROR MESSAGES 
Any invalid AB syntax» PB syntax» or missing file condition is 
detected by the MCP. Errors handled by SYSTEM/BACKUP are 
described below. 3 
le <filename> - EOF REACHED» NO RECORDS PROCESSED 
Displayed if the file has zero records or the option speci- 

fications can not be satisfied. Examples RECORD 1000 2000 

when the file contains only 300 records. 
2@e <filename> - FILE NOT PRESENT 


Displayed if the backup file specified cannot be founds eege» 
already reaoved. 


3. <filename> - COLUMN OF ZERO NOT ALLOWED 


KEY coluan is base 1 relative. 


he <filename> - KEY LENGTH OF ZERO NOT ALLOWED 


5- <filename> KEY LENGTH SPECIFIED TO00 LARGE 


Maxiaum of 9 characters | 


6. <filenase> RECORD START OF ZERG NOT ALLOWED 
Record count is base 1 relative. 
7. EXCEPTION ON READ - <filename> 


Report exception until block is exhausted or untit a good 
read. Skips bad btocks and continues processing rather than 
teraginatinge. | aa 


8. MISSING HOST —- <hostnasre> 


Reported when attempting to print or punch a backup file on 
another system which was not available at cpen time. 
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